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DOS, THE IN# COMMAND, AND THE PR# COMMAND 


DOS uses the Apple I/O vectors to intercept commands from BASIC. The PR# 
and INË statements modify the I/O vectors directly which makes it 
impossible for DOS to see subsequent commands from BASIC. The usual 
symptom is that the DOS doesn”t work after you turn the printer on or off. 
Please read pages 19% to 195 of the DOS manual for a complete 

discussion of these effects and how to avoid then. 
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BINARY FILE ADDRESS AND LENGTH PARAMETERS 


The starting address and length of a binary file are loaded into two 
registers in memory when the file is loaded. Page 144 of The DOS Manual 
has the addresses to look at for this information. To find the starting 
address and length of the FID program on the master diskette: 


BLOAD FID 
PRINT "ADDRESS = "; PEEK (43634) + PEEK (43635) * 256 
PRINT "LENGTH = "; PEEK (43616) + PEEK (43617) * 256 


which would return the starting address of 2051 and a length of 4686. 
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DOS COMMANDS BEING IGNORED 


The control-D of a DOS command must be the first character on an output 
line. This means that ít must be immediately preceded by a carriage return. 
If it isn't, the command will be printed out to the screen or the printer 


and ignored by DOS. 


The most common cause for this is having a GET statement or a PRINT 
statement that ends with one of the following: 


semi-colon (;), 


comma (,), 
TAB, or 
SPC 


as the last 1/0 operation before the command that gets ignored. An extra 
PRINT before the next DOS command will generate the carriage return required 
for it to be recognized. 


Another solution to the problem is to define D$ as a carriage return and a 
control-D: 


19 DS = CHR$ (13) + CHRS (4) 
Another cause of DOS commands being ignored is improper use of the IN# and 
PR# commands. IN# and PR# are DOS commands. They must be send out as: 


19 PRINT CHRS(4); "INPO" 
20 PRINT CHRS(4);"“PR#O" 


See pages 109 through 193 of the DOS manual for further explaination. 
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DOS DISKETTE USAGE 


Apple Disk IIs use the bottom surface of the diskette to save the data. 
The top surface has a "loading head" to keep the diskette in contact with 
the head. 


We don’t recommend using both sides of the diskette for data. The loading 


head collects a lot of dust and dirt during normal operation. Turning the 
diskette over will expose the data surface to the abrasive affects of this 
dust and may cause loss of data. 
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MUFFIN can^t convert some 13 sector diskettes because of the software 
protection scheme used on them. The same diskettes usually won't copy 
either. These diskettes will have to be used by booting with the BASICS 
diskette or BRUNning BOOT13 on the DOS master diskette. 
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DOS AND THE I/O VECTORS 


The Apple monitor sends all input and output through a pair of two byte 
vectors. DOS takes the contents of the vectors and saves them in its own 
memory and puts pointers to itself in the monitor’s I/O vectors. Since 
both BASICS use the monitor routines for their 1/0, DOS can intercept and 
interpret commands from Applesoft and Integer Basic. 


If for some reason the I/O vectors are changed, DOS is no longer able to 
intercept commands. There is a routine in DOS that will check the monitor 
I/O vectors to see if they point to DOS. This routine will store the 
current vaules in the I/O vectors and put a pointer to DOS in the vector if 
DOS isn^t already there. This routine starts at $3EA and can be accessed 
from Basic with CALL 1002. It is most useful when the I/O vectors need to 
be modified to a custom I/O routine like the Hi-Res Character Generator 
routine in Contributed Software, volume 3.  Here^s how to use the Character 
Generator and DOS: 


19 POKE 54,6 


20 POKE 55,96 
30 CALL 16892 


40 PRINT CHRS(4); "CATALOG" 
SÓ PRINT CHRS(4); "PRO" 
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INTBAS AND FPBAS ON THE MASTER DISKETTE 


The INTBAS and FPBAS files on the master diskette are there to load the 
language card if there is one in the system when the disk is booted. These 
files are written to operate in the memory space of the Language Card and 
will not work anywhere else. 


People with an Apple II who want Applesoft need either the Applesoft 
Firmware Card or the Language Card. 


People with an Apple II Plus who want Integer Basic need either the Integer 
Basic Firmware Card or the Language Card. 
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HIDING MACHINE LANGUAGE ROUTINES ABOVE THE DOS FILE BUFFERS 


It is possible to position machine language routines between DOS and it’s 
first file buffer. Routines hidden this way can't be overwritten by Basic 


programs. 


S$9DÓÓ and S9DÓ1 (48K system) point into the first, highest, buffer. Add 
the number of pages (256 byte blocks) your routine needs to the contents of 
59D01. Put a SÓN at the address now pointed at by the contents of 

S9DÓÓ, S9DÓl. Also store a $Ø at the address pointed at by the contents 
of S9DÓ9, SO9DÓl plus $25. Perform a JSR S$A/D4 which will rebuild the DOS 
file buffers and move the current Basic/s HIMEM down. The first available 
address for your routine will be the address pointed at by the contents of 
S9DÓQ, S9DÓl plus $2D. 
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BRUN HELLO? 


When DOS is booted it will "RUN" the program that was in memory when the 
diskette was initialized. You can change DOS so that it will "BRUN" the 
HELLO file instead. In a 48K Apple change the byte at S9E42 from $686 to 
$34. The following sequence of commands will create a disk that will BRUN 
HELLO when it is next booted. First put a blank diskette in the drive. 


CALL -151 

9E42:34 

3DØG 

INIT HELLO 

DELETE HELLO 

BLOAD BINARY PROGRAM (from another diskette) 
BSAVE HELLO (on the new diskette) 


APPLE TECH NOTES Copyright (C) 1981 by Apple Computer, Inc. 


Ses m E A ii bi mr GE pem mi UND vn ik ld: ls Her ions cm SSG er AS - CUR PR. PP VEND ded icum am maps amp ca r vh, CR m dm A BA m n nm AH n n mpr r. p p r. 


DOS AND INTERRUPTS (IRQ) 


Interrupting the Apple^s 6592 while using DOS can be treacherous. DOS uses 
location $45 when converting user supplied decimal numeric parameters to 
hexadecimal for its internal use. The Apple monitor’s interrupt handler 
also uses $45 to save the 6502 accumulator. So, if an interrupt occurs 
while DOS is parsing a command, the numeric parameters that DOS uses when 
it executes the command will be changed. DOS also uses $45 when displaying 
the sector length of the files in a catalog so an interrupt can also cause 
them to be wrong. 


DOS uses timing loops during its read and write operation.  Interrupting 
the Read Write Track Sector routines can kill a disk. DOS protects itself 
from IRQ, but has no control over NMI. Don’t use NMI while using DOS. 
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NOT DIRECT COMMAND ERROR 


DOS will sometimes return a NOT DIRECT COMMAND ERROR when sending it 
commands from machine language routines. When DOS receives certain 
commands ít checks to insure that the current BASIC interpreter is running. 
It does this so that the user can respond to an INPUT statement with 
"RUNNING" without trying to run the file "NING". There is a list of what 
commands are limited in this sense at the bottom of page 122 of the DOS 
Manual. The following, relocatable machine language routine will insure 
that DOS is satisfied. 


LDA £586 

STA $33 This location must not equal $DD 

STA $76 This location must not equal $FF 

STA $D9 This location must be greater than $/F 
RTS 


APPLE TECH NOTES Copyright (C) 1981 by Apple Computer, Inc. 


— — — 
—— aw re ee — — o da e -— m -m ~ o om oam de - cum c m APO. o m m k m m Ln m cum o um m oom ced EP m cum Cue d» m P UR oum um cm am um E A nb CHUA p cm mcum cu m mcm 


mm, n — cm cam o m A -< —— om —— — ee e X X c P pom cum cu Pom came a Rp aum cup P Umm K cu uA X ee ewe ew ee ew eee 9 0 cum cdm c A eee eS cu um cab AB wd CU O Po m 


MACHINE LANGUAGE ACCESS TO DOS | 


There are two ways to use DOS frou machine language routines, the Read 
Write Track Sector routines and the normal DOS commands. Pages 94 to 98 of 
the DOS manual describes how to use RWIS to access any part of the 
diskette. Be warned that RWIS will allow you to write anywhere on the 
disk, even over existing files, the DOS image, and the catalog. The other 
way is to send the normal DOS commands, one character at a time the normal 
output channels. The characters need to be sent out in the 6592 
accumulator with a JSR to SFDED. Remember to precede the commands with a 
carriage return and control-D aud follow it with another carriage return. 


Here is a short routine to do a catalog. 


190: A22 99 LDX #599 ;Initialize index | 
392:BD 29 $93 LDA $0329,X ‚into text table | 
395:FO $9 BEQ $3PC :ŞØ marks the end | 
397:29 89 ORA #589 ‚DOS likes high bit set | 
365:29 ED FD JSR SFDED ;Character output routine | 
398:E8 INX ;Prepare for next character | 
309:DO F3 BNE $0302 ;Always taken | 
39B:60 RTS | 


320:0D f4 43 41 54 41 4C 4F 47 ØD 99 
CATALOG 


Here is a short-cut if Applesoft is available. 


39D: A9 29 LDA #$2¢ ;Low byte of table address 
302:A9 $93 LDY #593 :High byte of table address | 
304:20 3A DB JSR $DB3A :Applesoft^s string printer | 
397 : 060 RTS | 


320:0D 04 43 41 54 41 4C 4F 47 ØD PP 
C XA T A LO € 


QD = carriage return 
$4 = control-D | 
Ø = end of line token | 
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DOS VS APPLESOFT HI-RES 


DOS uses and does not restore $26 and $27 while reading text files. These 
are the locations used by the Applesoft Hi-Res routines to save the last 
plotted point. Programs that mingle DOS commands and HPLOT TO X,Y 
instructions will not give the expected results because DOS will overwrite 
the information that Applesoft has put in $26 and $27. Here is an example 
of a program that reads a text file and plots the data it reads. 


10 DS = CHRS(4) 

20 HGR 

3% PRINT DS;" OPEN FILE” 

40 PRINT D$;"READ FILE" 

59 HPLOT 4,0 

60 Tl = PEEK (38): T2 = PEEK (39) 
70 INPUT X,Y 

80 POKE 38,T1: POKE 39,T2 

9% HPLOT TO X,Y 

199 IF X + Y > f THEN 608 :REM STOP WHEN X+Y=@ 
119 PRINT DS;"CLOSE FILE" 
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DOS 3.3 AND THE LANGUAGE CARD 


DOS 3.3 looks at location $EØØØ on both the mother board ROMS and on the 
firmware card to see if the desired version of Basic is avaialble. If 
there is a Language card and it were to power up matching one of the two 
signature values, DOS would jump into the random information on the card 
assuming that it was Basic. To prevent this DOS stores a SÓD at SEQ90 on 
the Language card during it^s boot process. The machine language 


instruction that does it is stored on the disk at Track g, Sector 9, 
starting at Byte SD3. 
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TRANSFERRING DOS TEXT FILES TO A PRINTER 


The following program will read a DOS sequential text file and send its 
contents to the interface in slot l. It is careful not to strip off any 
leading spaces. 


1000  ONERR GOTO 2000 

1010 LET DS = CHRS (4) 

1929 INPUT "FILE NAME? ";F$ 

1030 PRINT D$;"OPEN “;FS 

1040 PRINT D$;"READ ";F$ 

1059 REM MAIN READ-PRINT LOOP 
1960 GET AS 

1978 PR# 1 

1080 PRINT AS; 

199% GOTO 186% 

2009 REM FILE DONE, FINISH UP 
2010 PRE Ø 

2020 CALL 1082 

2030 PRINT 

2049 PRINT D$; "CLOSE" 

2050 END 
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NONSTOP CATALOG 


The CATALOG command stops every 18 lines to allow the user to read the 


information on the screen before continuing. This pause can be deleted by 
changing three bytes in memory. In a 48K Apple: 


POKE 44691,234 
POKE 44692,234 
POKE 44693 ,234 
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DOS TEXT FILE FORMAT 


DOS sequential text files store information as strings of ASCII characters, 
just as if the disk were a printer. Therefore numeric variables are stored 
as a string of characters rather than in their internal format. The number 
of characters required by a given variable, VAR, can be found with: 


PRINT LEN (STR$ (VAR)) 


The carriage return or other separator that is also sent out after the data 
will also require a byte, allocate space for it!!! 
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CURRENT STATUS 


The following locations reflect the current status of DOS. Changing these 
locations may not change what DOS will do next. The addresses assume a 
48K Apple. 


Address Descríption 
Dec Hex 
-18441  B7F7 Last used slot 
~18449  B7F8 Last used drive 
-21933 AA53,AA54 Character out vector (CSW) 
-21931  AA55,AA56 Character in vector (KSW) 
-21929  AAS7 Current Maxfiles 
-21928 AA58 Default Maxfiles 
-21922  AA5DE MON vs NOMON status (bit 6 = Command) 
(bit 5 = Input ) 
(bit 4 = Output ) 


-21914 AA66,AA67 Volume (read only) 

-21912  AA68,AA69 Drive (OK to change) 

—21910 AA6A,AA6B Slot (OK to change) 

-21908 AA6C,AA6D Record length 

-21906 AA6E,AA6F Record number 

-21904  AA79,AA71 Byte in record 

—21902  AA72,AA73 Address 

-21899  AA75-AA93 Filename ($AA75 = $Ø for CATALOG etc.) 

-21834 AAB6 Which BASIC ( f-Int) 
( 64=AS ROM) 
(128=AS RAM) 
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WHICH VERSION OF DOS IS THIS? 


You need to look at two locations to determine which version of DOS the 
Apple booted with. You need to check both locations to be completely sure. 
These addresses are for a 48K Apple. Subtract $4899 (16384) for a 32K 
system or $8900 (32768) for a 16K system. 


ADDRESSES 


DOS $9D@2 (-25342) $BD84 (~17926) 


3.1 $4D ( 77) $DØ (298) 
4:5 $81 (129) sng (298) 
3.2.1 $81 (129) SAE (174) 
3.3 $81 (129) $6B ( 11) 
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BASIC ENTRY VECTORS FOR DOS 


The following table shows the re-entry points DOS uses for the current 
Basic. You can change these to re-enter your machine language routine 
after a command or DOS error. These addresses are for a 48K Apple. 


Addr INT ASROM ASRAM Description 

$9D56 36 E8 - = Chain entry 

$9D58 E5 24 FC 24 $6 25 Run 

S9D5A E3 E3 65 D8 67 19 Error entry 

S9D5C 00 ED $9 EB 84 1D Initialize Basic memory 
$9p5E 03 EB 3C D4 3C $C Continue after DOS commands 
S9D6$ - F2 D4 F2 BC Line link resequence 


APPLE TECH NOTES 


Copyright (C) 1981 by Apple Computer, Inc. 


u— — siehe ee ee ee e ee ee ee ee ee n ams um umm Em uus ee UND CURE ee ee ee Er ee eee A A GE e VE ccc cc c ra A c —— n 


ub re n n n <n can SW AMD na m ap nn AMD n n ER A e MD GE m UND UR idR VAR GNU n GER r GEM e EN ED SS ED ES es SD OD Uu m m mu a cum Gap ME P. ZP AR AINE CENE A A e 


RENUMBER FIX 


The Renumber program on the master diskette has an error. 
mistakes the number after a "*" as a line number and renumbers it. 


you had a line 


10 LET AsB*1$ 


it might become 


Here is 
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20 LET A=B*29 


a permanent fix for the problen: 


For RAM Applesoft 
(DOS 3.2) 

LOAD RENUMBER 

POKE 14342,172 

POKE 14343,171 

UNLOCK RENUMBER 

SAVE RENUMBER 

LOCK RENUMBER 


(DOS 3.3) 
LOAD RENUMBER 

POKE 14316,172 

POKE 14317,171 

UNLOCK RENUMBER 

SAVE RENUMBER 

LOCK RENUMBER 


Sometimes it 
So if 


For ROM Applesoft 


LOAD RENUMBER 
POKE 4815,172 
POKE 4816,171 
UNLOCK RENUMBER 
SAVE RENUMBER 
LOCK RENUMBER 


LOAD RENUMBER 
POKE 4789,172 
POKE 4799,171 
UNLOCK RENUMBER 
SAVE RENUMBER 
LOCK RENUMBER 
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BOOTING WITHOUT A DISK IN THE DRIVE 


The disk drive will run continously if there isn^t a readable dískette in 
place. This includes trying to boot a 13 sector diskette on a 16 sector 
Apple and vise versa. It^s OK to insert a disk while the drive is running. 
The only other way to stop the drive is to turn off the power or press RESET 
(or control-RESET). 
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THE PROGRAM APPLESOFT ON THE DOS 3.3 MASTER DISKETTE 


The program APPLESOFT on the DOS 3.3 master diskette is not the Applesoft 
language. It^s a program to load the Applesoft language into your language 
card if you have one. If you type FP, DOS will run the program called 
Applesoft on the master diskette which will check for a language card, load 
the language card with Applesoft from the file FPBAS if there is one, and 
leave you in Integer Basic command mode. You can replace the APPLESOFT on 
your diskette with the APPLESOFT MUFFINed from a DOS 3.2 diskette and use 
the FP command as per the manual. 
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The DOS master diskette contains a utility program called CHAIN. There are 
instructions on its use on page 196 of The DOS Manual. There a few things 
to look out for though. 


CHAIN does an effective PR#% and IN#@ when it is used. This will disable 


an 8@ column card or a Hi-Res character generator. The first program can 
save four memory locations that, when the second program restores them, 


will leave the input and output vectors unchanged. 


63000 REM PREPARE TO CHAIN 

63010 J = PEEK (999) + PEEK (19090) * 256 - 116 
63020 FOR K = f TO 3 

63030 A(K) = PEEK (J+K) 

63040 NEXT K 

63050 REM CHAIN NOW 


lg REM PROGRAM #2 

20 FOR K = Ø TO 3 

30 POKE J+K,A(K) 

40 NEXT K 

50 REM REST OF THE PROGRAM 


CHAIN overlays the existing Applesoft program with the new program. Watch 
out for programs that use DEF FN and ONERR GOTO statements. You will have 
to re-execute these statements in the new program if they are to work 
properly. Both statements contain pointers into the program text and the 
text probably isn't the same in the new program. 
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RENUMBER AND THE MAXFILES COMMAND 


Applesoft Renumber won”t work with a MAXFILES other than 3.  Renumber is a 
machine language program that is loaded as an Applesoft program. When the 
Applesoft program Renumber is run it relocates the machine language up to 
HIMEM in your system. DOS defaults to MAXFILES 3 so HIMEM is on a page 
boundary, $9699 in a 48K Apple. But changing MAXFILES moves HIMEM off the 
page boundary.  Renumber^s relocator will still do the move, but it doesn't 
relocate the address properly. The usual symptom is to drop into the 
monitor with an address in the range $0299 - $0399. 
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RENUMBER AND THE FRE (Ø) COMMAND 


Renumber doesn't always reset the variable pointers when it returns to 
Applesoft. This will cause the Apple to hang or drop ínto the monitor when 
the PRINT FRE (Ø) command is used. To check the amount of free memory left 
after a Renumber operation simply do a CLEAR before the PRINT FRE (Ø). 
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PHONE LIST - PRINTER PROBLEMS 


The PHONE LIST program provided on the DOS 3.2 Plus Master Diskette will 
not print correctly on the Silentype printer. This can be corrected by 
adding the following line to the program: 


1111 IF PR THEN PRINT 
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The APPEND command will open a sequential file and read through all the 
records in that file until it finds the end. Then the next WRITE command 
will append information to the end of the file. Unfortunately, there are 
some problems with APPEND: 


When the last carriage return being written out is also the last byte in 
the last sector of the file, DOS doesn't bother allocating another sector 
for the end of the file mark. So the next APPEND never finds the end of 
the file and the file pointer gets left at the beginning of the file. The 
next write command will write over the first record. 


One way to tell if this will happen is to try a READ after the APPEND 
command. If the read returns an “OUT OF DATA” error then you can do a 
normal APPEND (I'm assuming that you're using ONERR GOTO in Applesoft). A 
sucessful read means that APPEND will over write the file. In that case 
the only way to add to the end of the file is to copy the entire file into 
another and write the new information into the new file after the old 
information is there. Then you can delete the old file and rename the new 
file with the old name. 


This problem was fixed in DOS 3.3. 


When a text file extends beyond 122 sectors and requires more than one 
sector of Track/Sector list, the carry bit in the 6502 is left in a set 
condition which will cause the first byte ín the 123rd sector to be 
skipped. Since the skipped over byte is a ff, the DOS READ command will 
stop at this point with an OUT OF DATA error and the subsequent data will 
be lost. This problem was fixed in DOS 3.3. 


If you write out a file of 255 sectors and then use APPEND to add more 
information to the file, you will wipe out random sectors in your file. 
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VOLUME NUMBER 


The volume number on a DOS diskette is kept in the address field of every 
sector of every track of the diskette. There is no way to change this 
information other than re-initializing the diskette. 
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DISK LAYOUT 


DOS reserves the first three tracks (@,1,2) of every disk for the boot 
image of itself and track 17 for the directory and VTOC. Tracks 1 and 2 
can be freed by modifying the bit map in the VTOC the disk will no longer 
be able to boot properly. ' 


The directory can be expanded by changing the link bytes in bytes l and 2 
of the last sector of the directory. 


The number of sectors required for a DOS file can be calculated: 


SECTORS = LENGTH / 256 + LENGTH / 256 / 122 


The first part of the expression is the physical number of sectors required 
to hold the data. This will be 2 bytes higher for a program and 4 bytes 
higher for a binary file. The second part is for the Track/Sector list. 
There will always be a Track/Sector list and a sector for data even if 
there is no data, so the minimum number of sectors for a file is two. 


Random access files are maintained through a Track/Sector list at the 
beginning of the file, as are all files. DOS will: 


Calculate which byte is the start of the record, 

Calculate which sector relative to the start of the file that byte 
would be in, 

Look up in the Track/Sector list which sector on the disk that 
will be, 

Calculate the offset into the sector, and 

Start writing data. 


(Continued) 
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DOS will allocate enough sectors of Track/Sector list to reach the required 
sector. DOS won't allocate any sectors if there hasn't been any data 
written to the records of that sector. Example: 


19 D$ = CHRS(4) 
20 PRINT D$: OPEN TEST, L500" 
30 PRINT DS; "WRITE TEST, R65" 
40 PRINT "HELLO" 
SØ PRINT.D5; CLOSE TEST” 

This program will create; 


65 records * 509 bytes = 32599 bytes = 126 sectors 


126 sectors = 2 Track/Sector list sectors 


for a grand total of 


L sector of data 
2 sectors of Track/Sector list 


There are no data sectors allocated for records 0 through 64. 
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NUMERIC STORAGE 


Numeric data that is stored in a DOS text file is not stored in a packed 
format. The information is on the disk in the same ASCII format that a 
printer would have received. Example: 


3.14159 7 bytes + carriage return 
B lL byte + carriage return 


There is no way under DOS to store packed variables. 
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LAROR HANDLING 


DOS errors automatically close all text files. In order for the text file 
to be accessed after executing an error handling routine, it must be OPENed 
again. 
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DISK FULL ERROR 


If you save 195 files on an l6 sector diskette and then try to access a file 


that isn't there, you will get a DISK FULL ERROR message instead of FILE NOT 
FOUND. 
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EXEC FRED will cause all requests for input to come from the file FRED. If 
you do an EXEC FRED command within a BASIC program, the file FRED will 
answer all of the BASIC program’s inputs until the end of FRED. If you want 
to use the EXEC to modify the program or execute some non-BASIC commands, 
END the program immediately after EXEC FRED so that FRED will supply 
characters to command mode. 


Exec files can't be used to respond to inputs directly from the keyboard 


hardware. As an example, a disk catalog with more than 18 entries will 
pause until a key is pressed; this keypress looks at the keyboard directly, 
and will not be overridden by the exec file. See Apple Tech Note 3799.922 


to defeat the CATALOG pause. 
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RANDOM ACCESS FILES 


Random access text files allow DOS to quickly read or write data anywhere in 
the file. They are maintained through a track/sector list as are all files. 
DOS calculates how many bytes and sectors into the file the first byte of 
the record belongs and moves the head to that spot. DOS acts as if all the 
records up to that number were written, and assigns real disk space only for 
the sector containing that record. This allows DOS to minimize diskette 
space usage for sparse files and still be able to write to intermediate 
records later without damaging the existing records. For example, record 19 
in a file of 4f byte records begins at the 4PPrh byte of the record, which 
is in the second sector of data. Therefore the track/sector list would show 
that that sector is allocated to the second track/sector entry, but the 
first entry would be nulls, indicating that space (ín the track/sector list) 


has been reserved but not yet assigned. 
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READING PASCAL DISKETTES 


Both DOS 3.3 and Pascal use the same recording format on the diskettes. DOS 
can read a Pascal diskette with the Read Write Track Sector routine, but 
there is a hitch. DOS uses 256 byte sectors while Pascal uses 512 byte 
blocks. The following table shows the correspondence between DOS’s track 
and sector numbers and Pascal's block number. 


TRACK SECTOR BLOCK 
l Y 6 high half 
l l L3 high half 
L 2 12 low half 
L 3 12 high half 
L 4 il low half 
1 5 11 high half 
1 6 19 low half 
l 7 1g high half 
1 8 9 low half 
L 9 9 high half 
i 10 8 low half 
1 LI 8 high half 
L 12 7 low half 
1 L3 7 high half 
L 14 6 low half 
L L5 13 low halt 


The rest of the disk is arranged the same. Add six to the block number 
for each increment of the track number. 


Refer to Apple Tech Note 6199.957 to read DOS format diskettes from Pascal. 
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ERRATA - THE DOS MANUAL 
A2LØØ36 
030-0115-99 


Page 41 
The last item in the table should refer to MASTER CREATE instead of MASTER 


UPDATE. 


Page 62 
Please note that in both line 100 and 110 there are no characters between 
the quotes. 


Page 193 
Note 3 refers to Table I which is actually TABLE 1 in the manual. 


Page 195 
Note 7 refers to Table II which is actually TABLE 2 in the manual. 


Page 196 
Applesoft CHAIN does a IN? and PRÉ. It will also reset LOMEM: to the 
top of the new program. 


Page 13 
Relative byte 22 of a directory entry is always a $00. 


Page 141 
The label on the left that says "Lowest RAM memory address:" should be at 
the bottom of the diagram and the arrow where it is now should read "1924 


(S0409)". 


Page 156 

The FP command assumes that you have a Language card, an Apple II Plus, an 
Applesoft firmware card, or the old RAM Applesoft on the diskette in the 
last used drive. We no longer offer RAM Applesoft. The FPBAS file on the 
Master Diskette will only work with a Language Card. 


Page 157 
Ihe first and third paragraphs are the same. 


(Continued) 
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Page 166 
RECOVERING FROM ACCIDENTAL RESETS, "If DOS has been booted and dhen...' 
should say "If DOS has been booted and then...”. 


Page 171 
CHAINING IN APPLESOFT Should read "To RUN" instead of "To REN”. 


Page 178 
The first paragraph mentions LOADAPA and the "&S" command which aren L part 


of the DOS package.  LOADAPA is a part of the DOS Tool Kit. There is a 
program on page 151 of the DOS Manual that will allow you to see 
control characters. 


APPLE TECH NOTES Copyright (C) 1982 by Apple Computer, Inc. 


mn — P pd O ee ee -— ee ee es ee — — — GE a — — v vi r vrd m a IA — — a—À a— a— — — SU — r m — —À dak r X HÀ id — — c— md CN ee r ee - n ee n - ai ide cm amm cum ee — — — 


Issued 29 Jul 82 DOS Tool Kit Page 38060.0090.91 


"P mb — — — wir -— ur MM Dl r m O A Poi —— —À — — — MO a mr mr V A u— l ou ARE GM Gm m, n n GERE n, a: ee OR d conus mr. GAMES n, UAM GEM m, GRE m Umum unum ale CNN m m GR GEN ARMES afa, — RO he he he ium um m Gu c mr m. 


INDEX TO DOS TOOL KIT 


ALPHABETIC LISTING 


Doc Title 

Dil ANIMATRIX - Paddles Required 

d1® APA - XREF and DATA Statements 

095 EDASM - Accumulator Addressing Mode 

099 EDASM - Disabling "PRESS SPACE TO CONTINUE" 
913 EDSAM - Generating Output Files 

094 EDASM - Indexed Indirect Addressing Error 
991 EDASM - PRÉ Command and Page Length 

096 EDASM - Printer Compatibility 

093 EDASM - Printing Text Files 

108 EDASM - RLOAD and String Variables 

097 EDASM - RLOAD File Name Restrictions 

092 EDASM - Using Relocatable Files 

991 Errata - Apple 6592 Assembler/Editor Manual 
399 Errata - The Applesoft Tool Kit Manual 

912 HRCG - Switching It On and Off 


NUMERIC LISTING 


Doc Issue Date Previous Date Pages 
0691 SEP 30 81 - l 
092 SEP 30 81 - 1 
$93 SEP 39 81 - l 
094 SEP 30 81 - l 
905 SEP 38 81 - ie 
096 SEP 30 81 - 1 
007 SEP 30 81 - Í 
9908 SEP 36 81 - 1 
999 SEP 36 81 - 1 
919 SEP 30 81 - 1 
Øll SEP 30 81 - 1 
012 SEP 28 81 - 1 
013 JUL 7 82 - 1 
999 JUN 3 82 APR 26 82 1 
991 JUN 28 82 APR 28 82 3 
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EDASM - PAGE LENGTH IN THE EDASM PR# COMMAND 


The PRÉ command is supposed to allow setting the physical and printable 
page length for your printer, but it doesn't work properly. It loses 
linefeeds and the listing will advance up the page. If you let EDASM 
default to formfeeds, it will print properly on most printers. 
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EDASM - USING RELOCATABLE FILES 


Relocatable files work if the REL is the first thing in the file and you 
include an ORG after it. The address in the ORG doesn't matter. 


REL 

ORG $309 * THIS NUMBEK IS REQUIRED BUT IGNORED 
TEXT EQU $409 
START LDA #SOD 

STA TEXT 

LDA #S@1 

STA TEXT + 1 

RTS 


This example creates a relocatable file that puts an inverse "@" and "A" in 
the upper left corner of the screen. 
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EDASM - PRINTING TEXT FILES 


EDASM is a great way to edit DOS text files, but the LIST and PRINT 
commands output to the screen. However, they can be diverted to the 
printer if the printer is activated with a direct DOS command. 


- PRÉ 
LIST 
PRÉ 


This will transmit the listing of the file to the printer just as it would 
normally go to the screen. The PR#® will be printed on the paper. 


Pressing the RESET key will turn off the printer and return to the editor 
if the Apple has an Auto-Start ROM. 
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EDASM - INDEXED INDIRECT ADDRESSING ERROR 


A single character argument to an indexed indirect addressing mode 
statement will assemble as absolute índexed instead.  EDASM will assemble 
"LDA (0,X)" as “9D MM Q9" instead of "Al PP". Adding a leading zero or a 
"S" to an address or using a multi-character label fixes it. 


L EQU $3 

EL EQU 54 
LDA (1,X) :9D $1 $6 WRONG 
LDA (82,X) ¡Al 02 RIGHT 
LDA (Dik) ;9D 03 pø WRONG 
LDA (LL,X) ;Al 94 RIGHT 
LDA ($5,X) ¡Al 85 RIGHT 
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EDASM - ACCUMULATOR ADDRESSING MODE 


EDASM requires that accumulator addressing mode instructions have an "A" as 
an argument. For example, "LSR A" is the proper syntax for "4A". 
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EDASM - PRINTER COMPATIBILITY 


EDASM assumes that the printer will do a carriage return as a part of any 
formíeeds it generates during an assembly listing. Some printers leave the 


print head at the last used character position and start printing the next 
heading at mid-page. 
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EDASM - RLOAD FILE NAME RESTRICTIONS 


RLOAD ignores spaces in the file name you give it. The statement 
30 ADRS=USR (8),"MY MODULE,S6,Dl" 


will look for the relocatable file "MYMODULE" on slot 6, drive |. 
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EDASM - RLOAD AND STRING VARIABLES 


The relocating loader is supposed to put the binary routine just below the 
current HIMEM in memory and set HIMEM to just below the binary routine. It 
does lower HIMEM but it doesn’t adjust the start of string storage pointer. 


Strings that are defined before using RLOAD may be over written and string 
variables used in the same program after using RLOAD may overwrite the 
binary information. 


One way to guarantee that strings won't cause problems is to have a short 
program do the RLOAD and then RUN or CHAIN your application program. 
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EDASM - DISABLING "PRESS SPACE TO CONTINUE" 
One byte needs to be changed to kill the "PRESS SPACE TO CONTINUE" message. 


BLOAD ASSM 
POKE 9292,96 

UNLOCK ASSM 

BSAVE ASSM, AS 1280, LS 22FB 
LOCK ASSM 
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APA — XREF AND DATA STATEMENTS 


The Applesoft variable command, &X, will hang if the program ends with a 
DATA statement. The XREF program is looking for a “:" to terminate the 


DATA statement. Adding a ":" to the end of each DATA statement will fix 
the &X problem. 
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ANIMATRIX - PADDLES REQUIRED 


Animatrix has no provision for controlling the grid cursor from the 
keyboard. 
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HRCG — SWITCHING IT ON AND OFF 


The Hi-Res Character Generator can be turned on and off under software 
control. The following two subroutines will switch back and forth. The 
variable "ADRS" is assumed to be assigned the same as in the subroutine 
starting at line 29009 of MAXWELL on the Tool Kit diskette. 


3000 REM TURN OFF HRCG 
3019 PRINT CHRS(4);"PRÉQ" 
3020 PRINT CHRS$(4);"IN£Q" 
3030 HOME 

3040 TEXT 

3650 RETURN 


4009 REM TURN ON HRCG 
4010 CALL ADRS + 3 
4020 RETURN 


Beware, the HRCG overwrites the text screen when outputting to the Hi-Res 


screen. It will destroy any information there. You will have to rewrite 
the text screen after using HRCG. 
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Issued 7 Jul 82 Dos Tool Kit Page 3899.913.91 


EDASM - GENERATING OUTPUT FILES 


EDASM will assemble a program and send it’s assembly listing to the screen 


or a printer. However, EDASM will not generate an OBJect file until it 
encounters an ORGin command. This is true for relocatable files too. 
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ERRATA - APPLESOFT TOOLKIT MANUAL 
A2L0038 
$39-0113-90 


Page ll 
The third paragraph should read: 


| 

| 

If you don^t want your program to print the title, change line 1898 to | 
| 

| 


180 CALL ADRS + 3 
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ERRATA - APPLE 6592 ASSEMBLER/EDITOR MANUAL 
0390-9112-99 
A2L9939 


Page 7 
"In the following descriptions and examples, the horizontal line" should 
read "...the vertical line" 


Page 17 
The end or the first paragraph should read "end of the range." instead of 
"end of the line." 


Page 19 
Paragraph 4 starts out "Back up your diskettes" when it means "Back up your 
files". It also should state that you use a different file name each time 


you back up your file. 


Page 2% 
The description for TLOAD mentions the appendix "Editor Tape Formats" which 
doesnt exist. See the TSAVE command. 


Page 26 

Paragraph 4, the tape format for TSAVE is different than Basic programs. 
It is similar to Integer Basic but not Applesoft. The files can not be 
loaded directly anyway because of the tokenizing of key words that both 
Basics do. 


Page 29 

The TSAVE format should be: 
(1@-second leader) 
(l6-bit file length) 


(18-second leader) 
(file data) 


(Continued) 
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Page 24 
The paragraph near the bottom of the page that starts "Here is" should read: 


Here is an example of this command, as it is typed at the keyboard 
.PRi*1,L54P66<control-I>80N 


and as it appears on the screen 


— n ea re ie ee 


.PR#1 ,L54P6680N 


Page 25 
The default tab settings are 14,19,29 


Page 28 
Paragraph 6, "Commands Available During Assembly" actually appear on page 
30 as "Assembly Mode Commands" 


Page 30 

The section, "Assembly Mode Commands", doesn't mention that the escape key 
will stop the listing like the space bar and switch the display to the 
right half of the virtual 88-column display. The space bar is used to 
reset the display to the left halt. 


Page 31 
Ihe second paragraph should start "The Listing OFF Command... 
"The Listing NO Command..." 


t: 


instead of 


Page 32 
The discussion of LABEL mixes the terms “Label” and “Symbol”. 


Page 32 
The last line refers to the appendix on Object File Formats. This 
information is on Page 48 and 49 under "Assembler Directive Summary” and 


"Operation Code Summary". 


Page 33 
Paragraph 2 line 6 refers to the syntax summary on page 49 when the 
information is on page 48. 


(Continued) 
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Page 69 
Byte 
Sector (Hex) Contents of byte 
L to 6 to Binary code image, of length in 
N cl+5 bytes 4 and 5 above 
c1l+6 Begin Relocation Dictionary, 


which consists of N 4 bytes entries 
N is variable (É to ?) 
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INDEX TO DOW JONES PORTFOLIO EVALUATOR 


ALPHABETIC LISTING 
Doc Title 


PAL Modifications to Use the Super Serial Card 


NUMERIC LISTING 


Doc Issue Date Previous Date Pages 


091 AUG 25 82 - 2 
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MODIFICATIONS TO USE THE SUPER SERIAL CARD 


Dow Jones Portfolio Evaluator expects to communicate with a Communications 
Card. However, the Communications Card and the Super Serial differ in 
three ways: 


* The location of the status and data registers are changed 

* The status register bit arrangement is different 

* The Super Serial card is switch dependent while the 
Communications Card must be programmed entirely in software. 


To make it work, put the Super Serial in slot 2 and set it^s switches to: 


Switch SWl Switch SW2 
: 23.4567 1234567 
Lp 016 L L 195115829098 


NOTE: THIS IS NOT THE SAME AS SUGGESTED FOR NEWS AND QUOTES. 
Next, you'll need to modify the software as shown below: 


LOAD LOGIN 

UNLOCK LOGIN 

5710 ST=49321: REM ADDR OF SS STATUS 

5720 DA = ST - 1: REM ADDR OF SS DATA 

5730 PRINT : PRINT CHRS(4)"PRZ2": PRINT CHRS(24) 

5740 PRINT CHRS(4)“PR#PD 

5780 FOR I = 1 TO LEN (1$):WAIT ST, 16: POKE DA, 
ASC(MIDS(IS, I, 1)): NEXT I 

5840 I = PEEK (772): IF I = 8 THEN I = 1 : REM ERR FLAG 

SAVE LOGIN 


LOAD FETCH 

UNLOCK FETCH 

6919 WAIT ST, 16: POKE DA, 17: REM XON 

7120 IF IN = 1 THEN WAIT ST,16 : POKE DA,19 : RUN 

7200 IF 5 * INT (S / 5) <> S THEN WAIT ST, 16: POKE DA, 17: 
GOTO 7369 

73090 WAIT ST,16: POKE DA,17: REM XON 

7900 ST=49321: REM ADDR OF SS STATUS 

7910 DA = ST - 1: REM ADDR OF SS DATA 

7920 PRINT : PRINT CHRS(4)"PR#2": PRINT CHRS(24) 

7930 PRINT CHRS(A)" PRI 9 

7970 FOR I = 1 TO LEN (I$): WAIT ST, 16: POKE DA, 
ASC ( MIDS (IS,I,1)): NEXT I 

8030 I = PEEK (772): IF I = 8 THEN I = l: REM ERR FLAG 

SAVE FETCH 


(Continued) 
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BLOAD COM22.0BJ 

UNLOCK COM22.0BJ 

CALL -151 

341:8 N 343:A9 N 34C:A8 
BSAVE COM22.0BJ,A$309 , LSBl 
FP 
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INDEX TO ELEMENTARY, MY DEAR APPLE 


ALPHABETIC LISTING 


Doc 


092 
996 


001 


NUMERIC LISTING 


Title 


Elementary, My Dear Apple and the Apple /// 
Errata - Elementary, My Dear Apple Manual 
Lemonade”s Music 


Doc Issue Date Previous Date Pages 
099 MAY 12 82 SEP 36 81 l 
091 SEP 39 81 - 1 
$92 SEP 25 81 - 1 
999 APR 26 82 SEP 39 81 1 
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LEMONADE^S MUSIC 


There ís no provision to turn off the music in the Lemonade program. 
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ELEMENTARY, MY DEAR APPLE AND THE APPLE /// 


Elementary, My Dear Apple vill not work on the Apple /// in Apple II 
emulation mode. 
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Issued 26 Apr 82 Elementary, My Dear Apple Page 4100.999.01 
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ERRATA - ELEMENTARY, MY DEAR APPLE MANUAL 
030-0114-900 


Page 2 

It is stated that when a blinking cursor and a prompt is shown, one can 
press the RESET key and you will always return to the main menu. There is 
a possibility that RESET will not return to the menu. In that case the 
system must be re-booted. 


Page 5 

In the paragraph beginning If you press a wrong key...." it says to go 
back and correct errors using the forward arrow key. It should say the 
back or left arrow key. 


Page 6 

After one is in the immediate mode, it is impossible to get back to the 
main menu without typing RUN INDEX after the prompt and the flashing 
Cursor. 


Page 7 
There is no mention that in the LEMONADE game you can use the arrow keys to 


correct mistakes. 


Page 18 

Paragraph 3, if you delete the entire word list with DEL 90150,9999 you 
should add line 4325 IF I = 9910 THEN 4332 to avoid problems with the 
problem editor. 
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INDEX TO FORMULEX 


ALPHABETIC LISTING 
Doc Title 


091 Formulex and the Apple /// 


NUMERIC LISTING 


Doc Issue Date Previous Date Pages 
099 MAY 12 82 OCT 28 81 1 
9091 OCT 25-81 - 1 
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FORMU LEX AND THE APPLE /// 


The Formulex package won”t work on the Apple /// in emulation mode because 
it is written in Pascal and there is no Language Card in the Apple ///. 
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INDEX TO FORTRAN 


ALPHABETIC LISTING 


DOC Title 

$55 Available Memory 

$12 Character Type Statement 

813 Compiler - Lísting File 

$1 Compiler Swapping in FORTRAN 

$97 Creating FORTRAN Data Files 

9095 Data File Limits 

øli Diskette Configuration 

999 Errata - FORTRAN Language Reference Manual 
PHO FORT2 Copy-Protection 

992 FORTRAN System Requirements 

208 Making the Most of Your Disk Space 

3903 Unformatted I/O in Apple FORTRAN 

209 Using Library Units in FORTRAN with Pascal l.l 
901 Using WCHAR from FORTRAN 


NUMERIC LISTING 


Doc Issue Date Previous Date Pages 
29. SEP 28 81 - l 
952 SEP 39 81 - l 
293 MAY 14 82 SEP 39 81 1 
393 SEP 38 81 - l 
POS SEP 30 81 - L 
$05 OCT 29 81 - i 
DUO SEP 39 81 - 1 
BO? OCT 29 81 - 1 
908 OCT 29 8l - t 
389 MAY 24 82 - 1 
219 OCT 29 81 | ~ i 
Øll SEP 3 82 JUN 16 82 2 
912 JAN 12 83 - i 
013 OCT 19 82 - l 
999 AUG 25 82 APR 26 82 1 
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USING WCHAR FROM FORTRAN : 


The Turtlegraphics WCHAR procedure, which writes a single character on the 


hi-res screen, will often give a "Value Range Error" (S£29, P#17, I#11) 
when called from FORTRAN. WCHAR does not check the high byte of the 
character word passed before calling the DRAWHBLOCK routine, so if the high 


byte contains a value, WCHAR will choke by trying to access an index beyond 
the end of SYSTEM.CHARSET. 


This error will occur when passing a single character from a character 
array, but not from a single character "string". For example 


CHARACTER CH(19) 
READ (*,1090) CH(1) 
CALL WCHAR (CH(1)) 


will result in a "Value Range Error". However, 


CHARACTER*L CH 
READ (*,109) CH 
CALL WCHAR (CH) 


will work correctly. To prevent the error in the first example, replace 
the call statement with 


CALL WCHAR (CHAR (ICHAR ( CH(1)))) 


which will convert the character to a integer, and then back to a character 
before calling WCHAR. 
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FORTRAN SYSTEM REQUIREMENTS 


The Apple Fortran system requires an Apple II or Apple II Plus with 48K 
of memory, the language system, and at least one disk drive. Use of two 
drives is recommended for ease of operation and for serious program 
development. 
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UNFORMATTED I/O IN APPLE FORTRAN 


Statements of the form PRINT*, READ*, or WRITE* are not allowed. All 1/0 
is of the form: 


READ ( «unit number? [, <format identifier? ] ) <iolist> 
WRITE ( <unit number? [, <format identifier? ] ) <iolist> 


Refer to pages 81 through 86 of the Apple FORTRAN Language Reference Manual 
for more information on the OPEN, READ, and WRITE statements. 
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AVAILABLE MEMORY 


Apple FORTRAN runs under the Pascal operating system, and has approximately 
37K available for user programs and data in version 1.0, and over 39K in 
l.1, with Swapping toggled on. Please refer to the Pascal l.l Update 
(addendum) for information on the Swapping option. 
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DATA FILE LIMITS 


Apple FORTRAN will allow a total of 16 files to be opened within a program. 
This is based on the number of file identifier blocks available within the 
Pascal operating system. However, available buffer space (memory) will 
more likely be the limiting factor in your FORTRAN program. 
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FORT2 COPY-PROTECTION 


The Apple FORTRAN compiler is protected and cannot be copied. A Bad Block 


scan of the FORT2: diskette will show blocks 39, 3i, and 32 as bad. DO 
NOT ATTEMPT TO "FIX" THESE BLOCKS AS THIS WILL RUIN THE FORT2: DISKETTE!! 
See your local service center if your FORT2: diskette doesn't work. 
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CREATING FORTRAN DATA FILES 


An error has been uncovered in the FORTRAN "CLOSE" statement which causes 
the operating system to mishandle the disk file space. If a data file is 
created within a program, closed, then reopened, the system will report 
that there is no room left on the volume, even if little data was actually 
written to the file. This is because the OPEN statement, with 
STATUS-"NEW", attempts to reserve all the unused blocks in the largest 
available space, and the CLOSE does not release the unused blocks when the 
file is closed. 


One way to avoid this problem is to "Make" a file on the given disk, of the 
size you will be needing. For example, your program might be creating a 
data file (by the name of "MYFILE") which will eventually occupy 199 blocks 
on your data disk (let^s call the disk "DATA"). From the Filer, type "M" 
(for Make), followed by "DATA:MYFILE[199]". This will create the directory 
entry, reserving 10% blocks for the data file. The FORTRAN program can 
then OPEN the data file with STATUS-"OLD", and the space will be managed 
correctly. When all the blocks are filled, the expected error messages 
will occur. 
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MAKING THE MOST OF YOUR DISK SPACE 


When using FORTRAN in a multiple-drive system, it is not necessary to 
duplicate system files on both FORTI: and FORT2:. Since the 
SYSTEM.COMPILER cannot be copied, FORT2: will by necessity have at least 
one file, but the majority of the space can be free for program 


development. Follow the procedure for formatting diskettes and 
transferring fíles which is described in the Pascal or FORTRAN reference 


manuals. 


Here are two possible FORTRAN configurations which can be used. Your setup 
will depend on your personal tastes. If you normally do not use, or intend 
to use, the system work file, you may wish to use this configuration: 


FORTL: (boot disk) FORT2: 
SAS TEM. APPLE SYSTEM.COMPILER 
SYSTEM.PASCAL 


STB LES HL SLENEO 
SYSTEM.CHARSET 
SOLE MEU LION 
SYSTEM.FILER 
SISTEM. LEER 
OYSTEM.LIBRARY 
FORTLIB.CODE 


With this configuration, FORT1: will have only 26 unused blocks, but 
FORT2: will have 182 blocks available for text and code files! If you 
exit the Editor by Writing a named file to FORT2: instead of Updating 
SYSTEM.WRK, youll have plenty of room to compile and link your FORTRAN 
programs. 


If you plan to use the system work file, use the folloving configuration, 
which will leave the majority of free space on the boot disk. This setup 
nay also be used for writing files, of course. The remaining space on 
FORT2 can be used for storing files not being used. 


FORTL: (boot disk) FORT2: 
SYSTEM.APPLE SYSTEM.COMPILER 
SYSTEM.PASCAL SYSTEM.LINKER 
SYSTEM.MISCINFO SYSTEM.EDITOR 
SYSTEM.LIBRARY SYSTEM.FILER 
SYSTEM.CHARSET 
FORTLIB.CODE 


For single-drive systems, please consuit your FORTRAN reference manual. 
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USING LIBRARY UNITS IN FORTRAN WITH PASCAL 1.1 


FORTRAN, running under Pascal version 1.1, does not access the 
SYSTEM.LIBRARY in order to find the location of each library segment. 
Therefore, in FORTRAN programs which use library units (SUSES <filename>), 
a stack overflow will occur almost immediately after execution begins. 


A program which will repair the segment dictionary of a FORTRAN code tile 
is included on the FORT2 diskettes. If your FORTRAN package does not 
include this program, you may get a copy frou your dealer or regional 
support center, or from the International Apple Core, on their April 1981 
Disk of the Month (called ATTACH). This Pascal program should be used 


after compiling and linking, but prior to the first execution of each 
FORTRAN program. 


Another method of forcing the operating system to load the locations of 
each segment is to compile the following Pascal program: 


PROGRAM READTABLE; 
USES TURTLECRAPEICS; (* or any other intrinsic unit *) 


BEGIN 
END “ 


Place the code file on your FORTRAN boot disk, and name that code tile 
SYSTEM.STARTUP. The program will be executed automatically during each 
boot and will cause the table to be read in. 
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COMPILER SWAPPING IN FORTRAN 


The FORTRAN compiler does not have a swapping option. Programs which fail 
to compile by exceeding the size of the symbol table will have to be 
reduced in size, or broken into several parts and compiled separately. 
Apple FORTRAN will allow compilation of program sections through the SEXT 
and SUSES compiler directives. Please refer to the FORTRAN Language 
Reference Manual for more details. 
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DISKETTE CONFIGURATION 


In a multi-drive system it isn't necessary to duplicate the system files on 
FORT2:. Here is a configuration for Apple Fortran diskettes that leaves 
you with over 130 blocks of storage on FORTl:, which remains the boot 
diskette, and allows you to write-protect FORT2: to prevent you from 
accidentally crashing the diskette that has the uncopyable Fortran 
SYSTEM.COMPILER . 


FORTI FORT2 

SYSTEM. APPLE SYSTEM.COMPILER 
SYSTEM.PASCAL SYSTEM.FILER 
SYSTEM.MISCINFO SYSTEM.EDITOR 
SYSTEM.LIBRARY SYSTEM.LINKER 
SYSTEM.STARTUP SYSTEM.CHARSET 


FORTMOD.CODE 
FORTLIB.CODE 
SYSTEM.LIBRARY 


The copy of SYSTEM.LIBRARY on FORT2: is a copy of the original that came 
on FORTl:. There is a little room left on FORT2: which makes a good place 
to archive it. The SYSTEM.STARTUP program is generated from Pascal and 
contains the following commands: 


PROGRAM LIBLINK; 
USES APPLESTUFF; 
BEGIN 

END. 


After compiling the program in Pascal, use the Filer to Transfer the 
codefile to FORT1: with the file name SYSTEM.STARTUP 


Here are some advantages of this configuration. 


* The files have now been arranged in a more logical manner in that 
one disk has the programs needed at run time and the second disk 
has program development routines. 


* The program development disk (FORT2:) can be removed from the | 
second drive after the system module is loaded from FORT2: to make | 
room for a data diskette. 


* The run time disk may be copied and one can develop each program 
on a seperate disk. 


* The user can modify the SYSTEM.LIBRARY without worrying about 
losing the original because is is saved on a write protected disk. 


(Continued) 
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The RTUNIT from the Fortran library can be added to the Pascal library so 
that the Run-time or program diskette can be used for Pascal, Assembly 
code, and Fortran by changing the disk in drive two. Some of the units on 
the Pascal l.l library are different from the units with the same name on 


the Fortran disk. The Pascal units will have higher revision numbers and 
later dates. 
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CHARACTER TYPE STATEMENT 


The syntax for the character type statement as described on page 49 will not 
compile properly. Example: 


Program Stríng 

Character* 199,A 

Write (*, ^(Ab)^) “Enter a 1® character string” 
Read (*, ^(A)')A 

Write (*, ^(A)^)A 

End 


This program will generate a compile error #28 in line 2. Removing the 


comma in line 2 will allow the program to compile and run properly. The 
manual shows the comma as an option. However, when a length descriptor 


follows the keyword "CHARACTER", as in line 2, it defines the length of any 
identifier that does not have a length descriptor of it”s own. For 
example: 


CHARACTER *19 A, B, LONG *299 
CHARACTER *20, SYZ *35, YGY, COMP *11 


Will make the following character declarations: 


A,B length = 19 
LONG length = 290 
SYZ length = 35 
YGY length = 29 
COMP Length = 11 


AS you can see, the second character declaration has a comma after the 


length descriptor *20 but only because SYZ has its own length descriptor of 
*35. Identifier YGY is defined with length 29 since it does not have a it's 


own length descriptor. 
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COMPILER - LISTING FILE 


During a compile, if you type "*" in response to "listing?", the system will 


appear to compile but will damage the Fortran disks. The problem is that 
"*" refers to the Console and the manual isn't explicit in stating that "*" 
isn^t legal at this level. 
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ERRATA - FORTRAN LANGUAGE REFERENCE MANUAL 
A2LØØ32 
030-90118-00 


Page inside cover 
The number A2DPP32 is for the diskette, not the manual. The correct number 
for the manual is A2L#932. 


Page ix 
The page number for the Appendices should be 135 instead of 134. 


Page xi 
The top paragraph should be deleted because the information is presented on 
page x. 


Page 156 
In a multi-drive system it isn't necessary to duplicate the system files on 
FORT2:. Here is a configuration for Apple Fortran diskettes that leaves 


you with over 130 blocks of storage on FORT1:, which remains the boot 
diskette, and allows you to write-protect FORT2: to prevent you from 
accidentally crashing the diskette that has the uncopyable Fortran 
SYSTEM.COMPILER . 


FORTI FORT2 
SYSTEM.APPLE SYSTEM.COMPILER 
SYSTEM.PASCAL SISTEMI LEER 
SYSTEM.MISCINFO SYSTEM.EDITOR 
SYSTEM.LIBRARY SYSTEM.LINKER 
SYSTEM.STARTUP SYSTEM.CHARSET 
FORTMOD.CODE 
FORTLIB.CODE 
SYSTEM.LIBRARY 


The copy of SYSTEM.LIBRARY on FORT2: is a copy of the original that came 
on FORTl:. There is a little room left on FORT2: which makes a good place 
to archive it. The SYSTEM.STARTUP program is generated from Pascal and 
contains the following commands: 


PROGRAM LIBLINK; 
USES APPLESTUFF; 
BEGIN 


END. 


After compiling the program in Pascal, use the Filer to Transfer the 
codefile to FORTi: with the file name SYSTEM.STARTUP 
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INDEX TO GOODSPELL 


ALPHABETIC LISTING 


Doc Title 


091 Goodspell^s User Dictionary 


NUMERIC LISTING 


Doc Issue Date Previous Date Pages 
DDD MAY 12 82 SEP 28 81 i 
091 SEP 21 81 u l 
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SOODSPELL”S USER DICTIONARY 


The user dictionary built while Goodspell is checking a file is kept in the 
Apple/s memory and can't be saved to disk. 
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INDEX TO GRAPHICS TABLET 


ALPHABETIC LISTING 


Doc Title 

0901 Area Calculation Errors 

90902 Circle and Disk Mode 

999 Errata - Graphics Tablet Manual 
093 Quickdraw 


NUMERIC LISTING 


Doc Issue Date Previous Date Pages 
099 MAY 12 82 SEP 28 81 1 
091 SEP 21 81 - 1 
092 SEP 18 81 - 1 
$03 AUG 25 82 - 1 
999 APR 26 82 SEP 28 81 1 
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AREA CALCULATION ERRORS 


The area calculation for the graphics tablet is not totally accurate. It 
was not designed to be used in critical situations, but rather as an 
example of the way such a tool could be used. The code is extremely 
simple, and the inaccuracies in Basic could account for the error 
encountered. 
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CIRCLE AND DISK MODE 


The CIRCLE and DISC routines in the graphics tablet manual do work, 
although the circle calculation is not accurate. It generates a circle 
with a radius larger than defined by the points plotted by the user. 
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QUICKDRAW 


Here are a couple of programs that demonstrate how to use Quickdraw. Type 
both programs in and RUN the first one. It will create an EXEC file and 
EXEC it (see DOS manual for furthers on EXEC). The EXEC file vill set the 
program to load above lii-Res and run the second program. The Graphics 
Tablet Interface is assumed to be in slot 5. Line 20 of the second program 
controls the slot number. 


19 DS = CHRS (4) 

20 PRINT DS"OPEN START.TEST" 
30 PRINT DS"WRITE START.TEST" 
4f PRINT "POKEL®3,L" 

58 PRINT "POKE164,64" 

60 PRINT "POKEL6384,9" 

70 PRINT "RUN QUICK-DRAW" 

80 PRINT "RUN TEST.QUICK.DRAW" 
9% PRINT D$"CLOSE" 

199 PRINT DS"EXEC START.TEST" 


ISAVE START.TEXT 


5 DIM XZ(599),YX( 509) 

19 DS = CHRS (4) 

20 PRINT DS"PR#5" 

30 PRINT "HL,S16,R" 

4$ PRINT DS"PR#B" 

45 DZ = L:EP% = PEEK (752) + PEEK (753) * 256 
46 NZ = 0 

47 HGR 

SÓ CALL EPZ 

60 PRINT NSZ 

70 N= NZ: FOR I = O TO N: PRINT XACI),YACI): NEXT I 
100 TEXT 


ISAVE TEST.QUICK.DRAW 
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ERRATA - GRAPHICS TABLET MANUAL 
039-0976-99 


Page 26 
The first word on line 5 should read "initialized" instead of 
“uninitialized”. 


Page 55 
The following lines are wrong: 


2475 GOTO 234¢ should be 2475 GOTO 235% 


2499 GOTO 2349 should be 249% GOTO 2348 


APPLE TECH NOTES Copyright (C) 1982 by Apple Computer, Inc. 


-am nn — A —— ee La es we a a, oo umo m mr m. a f r. ME mr A m d —À —— m —MÀ b mr. X — — man M — — — mu X o m - m — o —À ME — —À L A — —— c o cx m — — ME — ee ee ee m 


Issued 1 Jun 82 Hand Holding Basic Page 4800.000.01 


— — "—— —À — a m ee T ÁO A A A o oom cum can A auum ma Mi ib GER - AGER ANA c ce um Gum Uus cum cun A umm cud cmm um cam cem Jib cem c m cm cum moo o c - -p UA ame A A sei CU A m A €um GE A UA O l Uu Ium 


INDEX TO HAND HOLDING BASIC 


ALPHABETIC LISTING 


Doc Title 
0902 Running the Demo 
991 String Arrays 


NUMERIC LISTING 


Doc Issue Date Previous Date Pages 
050 JUN 1 82 MAY 12 82 L 
DOL NOV 23 81 - l 
002 MAY 21 82 = l 
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STRING ARRAYS 


Hand Holding Basic doesn’t support string arrays. The program acts as if 
if were a syntax error and prompts for an acceptable character. 
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RUNNING THE DEMO 


Instructions were missing on how to run the Demo Program in the early 
version of the manual. To run the Demo Program, get into Level 4 
(see the instructions are on page 46) aud type in 


ROLLING DEMO 
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INDEX TO HIGH -SPEED SERIAL INTERFACE 


ALPHABETIC LISTING 


Doc Title 

$03 Apple Video and Printing 

012 Batch move routines and Applesoft 

014 Carriage Return Delay 

011 Current loop operation 

991 Errata - Addendum to the Serial Interface Card Manual 
999 Errata - Serial Interface Card Manual 

09 Initializing with POKEs 

005 The P7-94 PROM 

094 The P8A PROM 

$98 Problem with Applesoft/s GET statement 

019 Remote Operation of an Apple in Basic 

096 Serial Card Space-on-Reset 

097 Serial handshake modification 

092 Tab Problems 

$13 Using an Apple with a Serial Card as a terminal 
9091 Using the Serial Card with the Qume Sprint 5 


NUMERIC LISTING 


Doc Issue Date Previous Date Pages 
091 OCT 19 81 - l 
092 OCT 19 81 - 1 
093 OCT 19 81 - 1 
$04 OCT 19 81 - L 
0905 OCT 19 81 - 1 
896 OCT 19 81 - 1 
097 OCT 21 81 - 3 
$08 OCT 21 81 - 1 
099 MAY 21 82 - 2 
619 OCT 22 81 - 1 
011 OCT 20 81 - l 
$12 OCT 2% 81 ~ l 
$13 OCT 29 81 - L 
614 JUL 12 82 - 3 
999 OCT 21 81 - l 
991 OCT 21 81 - l 
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USING THE SERIAL CARD WITH THE QUME SPRINT 5 


Set up the Qume: 


Form length :11 inches 

Character spacing :10 or 12 

Twintellect ¿Standard 

Auto LF ¿On 

Parity : Mark 

Duplex :Test (For normal operation :Full) 
Baud rate :1299 


The two switches inside the cover should be set to "MOD" and "HI". 


Set up the serial card: 
Be sure that the P8A PROM is installed at location B2 
The switch on the Serial card should be set to; 


1 2 3 4 5 6 7 
Off Off On Off On Off On 


Enter and run this program 


19 PR# 1 
26 PRINT CHRS (27); CHRS (26); CHRS (14) 


30 PREG 


The Sprint 5 printer will do the Self Test and print "Self Test OK", then 
it will print the entire character set until the Duplex switch is set to 
Full. 
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TAB PROBLEMS 


TAB does not work properly with the High Speed Serial Interface. In 
Integer Basic it is limited to 4f columns and in Applesoft, TAB(29) will 
sometimes output 2 spaces instead of going to column 20. Here is an 
example that gets around this problem. 


LØ PRINT "HI";: POKE 36,55: PRINT "THERE" 
HI THERE 
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APPLE VIDEO AND PRINTING 


If you are sending information to a printer with the Serial Card’s line 
width set to greater than 4@ and echoing the information to the Apple 
screen, vou may wipe out your Applesoft program. Apple's screen is memory 
mapped and an offset greater than 4@ will cause the information to be 
"printed" in the same memory as the start of your Applesoft program. You 
can use the printer or the video but not both at the same time. 
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THE PBA PROM - 


line and waits for the printer to send back an ASCII ACK Cetrl-F) delo 
allowing the Apple to continue executing its program. Pins 2% 3 on the 
interface connector must be connected straight across and the printer must 
be able to send the ACK or the Apple will stop after the first Line that 
it sends. Printers that support the PBA are: 


The P8A prom sends an ASCII ETX (ctrl-C) to the priater at the end of eac! 


Anderson Jacobson 832 (send <esc>!w to set the AJ s mode, pg 3-30; 
Qume Sprint 95 
NEC Spinwriter 


The P8A prom uses location $3C as a temporary memory register. Many of the 
monitor commands can't be used with the printer due to this conflict. 
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THE P7-64 PROM 


Early versions of the High Speed Serial Card would not work with certain 


other cards in the next higher numbered peripheral slot. The P7-ß4 PROM 
has solved this problem. 
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SERIAL CARD SPACE-ON-RESET 


When driving a printer like the Qume the alarm sounds when the Apple is 
first turned on. This is because the 74LS109 was wired to send out a 
"space" instead of a "mark" level when the Apple is RESET. 


Swapping pins l and 5 on the 74LS109 will solve the problem. It can be 
done on the board or at the socket. 
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SERIAL HANDSHAKE MODIFICATION 


INTRODUCTION: 


The High Speed Serial Interface card cannot run faster than 309 baud on 
most printers due to a lack of a printer busy line. This modification uses 
the existing data input line to sense if the printer is busy and inhibit 
output if necessary. This modifícation will work with cassette, DOS 3.2, 
or DOS 3.3. 


WARNING: 


Damage to the High Speed Serial Interface card may not be covered by your 
warranty. If you aren't sure of the signal levels and pinout of your 
printer, find out or get someone who knows to help you. 


WIRING CHANGES: 


First you must determine which wire your printer uses to indicate a printer 
busy or buffer full condition. Your printer^s manual should contain this 
information or contact the manufacturer. 


Examples: 

IDS 125/225 pin 4 
HEATH H-14 pin 4 
TI-819 pin 1l 
SPINTERM pin 19 
COMPRINT pin 2¢ 


The preferred place to do the wiring change is in the cable, but it can 
also be done at the Serial Card or the printer. Disconnect the wire 
between pin 2 of the printer and pin 2 on the Serial Card. Then connect 
the wire with the printer busy signal to the wire for pin 2 on the Serial 
Card. 


SOFTWARE PATCH: 

Next you must decide which slot the interface will go in and type in the 
software patch. The patch is customized for this slot number and won't 
work if used with a different configuration. The patch forces the computer 


to look to see if the printer is busy and wait if it is. Enter the patch 
using the values from the table for words in brackets, < >. 


(Continued) 
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SLOT 1 2 3 4 2 6 7 
DATA 99 AQ BØ cø DØ EP FG 
CODE Cl C2 C3 C4 C5 C6 C7 


Enter the monitor with CALL -155 and type 


3B0:A9 «SLOT» 
:20 95 FE 

:A9 00 

:20 ED FD 

¿A9 C5 

:85 36 

:A9 $3 

:85 37 

:4C EA 43 

:2C «DATA» CÓ 
:30 FB 

:4C 07 <CODE> 
:ØØ 09 90 


To check your typing, type 
3BÖL 


and compare your listing to the one below for slot l. 


03BÓ- AI f LDA — £SÓ1 
03B82- 26 95 FE JSR  SFE9S 
03B5- A9 Bd LDA ¿Spb 
Q3B7- 28 ED FD JSR  SFDED 
03BA- . A9 C5 LDA — £$C5 
038C- 85 36 STA $36 
Q3BE- AI 3 LDA #583 
G3c¢- 85 37 STA $37 


03C2- 4C EA @3 JMP . $93EA 
03C5- | 2C 90 cø BIT  $SC$99 


03C8- 30 FB BMI $93C5 
Ö3CA- | 4C 47 Cl JMP  SC1987 
03CB- 00 BRK 
g3cc- pp BRK 
03cD- pp BRK 


Now return to basic with 3D$C. 


SAVING THE PATCH TO DISK: 


(Continued) 
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The patch must be in memory before the printer can be used at the higher 
speeds. Save the patch by typing 


BSAVE PATCH, A$3BØ, L$2P. 


USING THE PRINTER: 


The first time you want to use the printer you must load the patch and 
initialize the interface. From immediate mode type 


BLOAD PATCH CALL 944. 
This may be done in a program, by entering 
109 PRINT DS;"BLOAD PATCH": CALL 944 


assuming that DS is a control-D. 


If in the course of the program you need to turn off the printer, type 
PR#Ø 

or in a program enter 
200 PRINT D$;" PRÉ" 

Then to reconnect the printer, all that is required is 
CALL 954 

or from a program 


300 CALL 954. 


NOTES: 
If the printer does not print after the CALL 944, it is probably sending 


the opposite polarity busy signal. The patch can be changed to recognize 
the opposite polarity signal with 


POKE 968,16. 


If this doesn^t work, have the printer checked. 


The modification allows the speed, column width, and other variables to be 
changed with the POKEs in the manual. 


APPLE TECH NOTES Copyright (C) 1981 by Apple Computer, Inc. 


p S dL P e let iii A i p b var ee TE (ME p rt PS noo VU E E... m. 1 > m nr. e mi MEN FE HEN r d iili o uu]. FU PU A k 


-— —Á» 0, -m f, mba mn cH — g e den vrr — ra — od, g r M9 9— — —— r. —À— -— A m mr. vmn mr vrd m. — — n - CE — —X i dd re 


PROBLEM WITH APPLESOFT/S GET STATEMENT 


The Serial Card interferes with Applesoft”s GET statement while echoing the 


input back out through the Serial Card. This causes the following prograu 
to fail. 


LØ INÉ1:PRZ1 
20 GETAS:PRINTAS; :GOTO29 


Ihe same program will work if the output is echoed to the Apple's screen. 


10 IN#L:PR#Ø 
20 GETAS:PRINTAS;:GOTO29 


This second program will print any lower case input as inverse on the 
Screen. 
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INITIALIZING WITH POKES 


Neither the PRÉ nor IN# commands in Applesoft and Integer Basic initialize 
the Serial Card. This can cause problems for the user who needs to modify 
the parameters of the interface for his application. He must send a 
character through the Serial Card before poking in the new parameters. The 
following POKEs will initialize the memory locations used by the Serial 
Card. Please refer to the Serial Card manual for more information on what 
each POKE will do. 


All occurences of "s" should be replaced by the slot number that the Serial 
Card is plugged into. 


LØ POKE 1144+s,64 BRATE, page 21 

20 POKE 1272+s,2 STBITS, page 21 
30 POKE l40-s,7 STATUS, page 22 
40 POKE 1528+s,9% Character counter 
50 POKE 1784+5,88 PWDTH, page 23 

60 POKE 1912+s,9 NBITS, page 23 

70 POKE 2940+s,129 FLAGS, page 24 


The following list of POKEs will replace the PR# and IN# commands which is 
required to benefit from the previous POKEs. The CALL 10902 should be used 
if you will be doing DOS commands while the interface is enabled. However, 
if speed is of the essence, don’t use the CALL 1002 until after the data 
transfer has been made since DOS does slow down i/O. These POKEs must all 
be on one command line separated by colons to work in command mode. They 
can have separate line numbers in a program. 


80 POKE 54,5 PR#s 
90 POKE 55,192+s 
100 POKE 56,7 IN#s 


110 POKE 57,192+s 
20 CALL 1992 


The normal way to reset the 1/O to the Apple video and keyboard is: 


900 DS = CHRS (4): REM CTRL-D 
919 PRINT DS; “PR#6” 
920 PRINT DS;"INÉ" 


However, this will only work after a PRINT and will be ignored after a GET 
or PRINT terminated with a comma or semicolon. To avoid having to do an 
extra PRINT you can use: 


900 CALL -375 : REM THIS IS IN#Ø 


910 CALL -365 : REM THIS IS PRÉ 
920 CALL 1902 : REM THIS RECONNECTS DOS 
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SPECIAL NOTE: Don’t allow echoing to the Apple^s video while printing. 
Your program or variables will suffer if you don^t disable the video output 
while printing lines more than 48 characters long. 
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REMOTE OPERATION OF AN APPLE IN BASIC 


Using a terminal and a High Speed Serial card to remotely operate an Apple 
can be interesting. To enable lower case input from a program you must do 
one of two things: 


Input at least one character in upper case mode before poking the value 
from page 24 of the manual. For example 


10 PRINT CHRS(4); "PRÉ3" 
20 PRINT CHRS(4); "INÉ£3" 
30 INPUT "PLEASE HIT RETURN”;AS 


49 POKE 2843,33 
50 REM THE REST OF THE PROGRAM 


The other method is to initialize the card yourself with pokes. 


199 LET SLOT = 3 

110 PRÉ SLOT : IN# SLOT 

120 POKE 54,7 

138 POKE 56,5 

140 CALL 16092 

159 POKE 1144+SLOT,8 : REM Baud Rate (p. 21 and 31) 
¿60 POKE 1272+SLOT,2 : REM Stop Bits (p. 21) 

170 POKE 14PP+SLOT,7 : REM Parity (p. 22) 

189 POKE 1784+SLOT,41 : REM Line Width (p. 23) 

198 POKE 1912+SLOT,9 : REM Data Bits (p. 23) 

209 POKE 2949+SLOT,33 : REM Operation Modes (p. 24) 
210 REM THE REST OF THE PROGRAM 
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CURRENT LOOP OPERATION 


The High Speed Serial Interface is the only interface we market 
with a 20ma current loop. It has an active send loop and a passive 
receive loop. 


Page 8 of the manual tells how to connect to an 33ASR teletype. This may 
not work with other 29ma devices. It assumes that the device has a passive 
send and receive loop. 


If the other device has its own active send loop then connect it as follows 


Connect pin 23 to Printer T 
Connect pin 7 to Printer - 
Connect pin 12 to Keyboard + 
Connect pin 13 to Keyboard - 
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BATCH MOVE ROUTINES AND APPLESOFT 


I have successfully used the batch move routines with Applesoft, both input 


and output. The only possible error I spotted is that after the PR£1 there 
must be a PRINT to initialize the interface. Using an IN*l will require an 
input. 
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USING AN APPLE WITH A SERIAL CARD AS A TERMINAL 


The Serial Card is not fast enough to be used as a terminal with a modem. 
It will lose characters from the input channel. The software intensive 
design of this card makes it unsuitable for high speed, bidirectional 
communications. 
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CARRIAGE RETURN DELAY 


INTRODUCTION 


This program introduces a variable time delay after printing a carriage 
return character. The delay gives slower printers time to return to the 
left margin without missing characters. DOS is required to use this 
modification. 


SOFTWARE ENTRY 


First you must decide which slot the interface will go in and enter the 
delay progran. The program is customized for this slot number and won L 
work if used with a different configuration. Enter the program using the 
values from the table for words in brackets, < >. 


The delay is measured in tenths of a second and entered in hexadecimal. 
Hence 5 is 1/2 second and A is one second. The usual default value is 5. 


Enter the monitor with CALL -155 and type 


390:49 «SLOT? 
:09 CP 

:8D AC 43 

:20 95 FE 

:A9 80 

:20 ED FD 

:A9 AA 

:85 36 

:A9 93 

185. 37 

:4C EA 03 

:20 07 Cl 

:C9 8D 

:DØ PE 

:A9 f5 (DELAY) 


:A9 C2 
:20 A8 FC 


:E9 Ol 
:DÓ F5 


To check your typing for the first twenty lines, type 


399L 
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and compare your listing to the one below for slot 1. Type another L to 
list the last two lines. The information below the RTS instruction isn't 
important. l 


$390- A9 fl LDA  #$Øl 
9392- 99 CÓ ORA #5C@ 
9394- 8D AC 03 STA . S03AC 
$397- | 20 95 FE JSR  SFE95 


039A- AD 86 LDA X £S$S89 
039C- | 20 ED FD JSR | SFDED 
939F- A9 AA LDA  #SA5 
B3Al- 85 36 STA $36 
03A3- AI 3 LDA X #S@3 
0345- 85 37 STA $37 


03A7- 4C EA Q3 JMP S03EA 
BIAA- 20 07 C1 JSR $C1@7 


Ø3AD- C9 8D CMP #S8D 
Ö3AF- D@ GE BNE  $Ø3BA 
9381- | A9 5 LDA #85 
0383- 48 PHA 

0384- | A9 C2 LDA  #$C2 
03Bbo-  2øØ A8 FC JSR  $FCA8 
23B9- 68 PLA 

93BA- £9 fl SBC. #S$@1 
Q3BC- DØ F5 BNE S@3AF 
B3BE- 66 RTS 


Now return to BASIC with 3D@G 


SAVING THE PROGRAM TO DISK 


The program must be in memory before the printer can be used with the 
delay. Save the program by typing 


BSAVE CR DELAY, A$390, LS$2F 


USING THE PRINTER 


The first time you want to use the printer you must load the program and 
initialize the interface. From command mode type 


BLOAD CR DELAY 
CALL 912 


This may be done from a program by entering 
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190 PRINT D$;"BLOAD CR DELAY” : CALL 912 


assuming that D$ is a control-D. 


If you want to switch back to the video monitor for output type 
PRÉ 
or in a program enter 


200 PRINT DS: "PRIO" 


Then to reconnect the printer, all that is required is 
CALL. 938 
or fron a program 


305 CALL 938 


AUDIO 
The delay can be adjusted from BASIC with: 
POKE 946, <DELAY> 


The delay in this case is in decimal. Then BSAVE the program again. 
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ERRATA - SEREAL INTERFACE CARD MANUAL 
A2L0908 
030-90012-96 


Page 16 
The information for switch 4 is reversed. It should read: 


ON 
OFF 


U 


delay enabled 
delay disabled 


Page 32 
Two labels on the schematic diagram are wrong: 


XMIT XMIT 
e OB "should be === ==0 © 
WIRE WIRE 

TO TO 

PIN 3 PIN 3 
RECV RECV 
-----0 C should be === B 
WIRE WIRE 

TO TO 

PIN 2 PIN 2 
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ERRATA - ADDENDUM TO THE SERIAL INTERFACE CARD MANUAL 
$31-909012-99 


Note: 


The P8A PROM interferes with the operation monitor routines that use $3C. 
The P8A uses this location as a temp and doesn't restore it. 
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